home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / programm.ing / rcs56.zoo / rcs / man / rlog.txt < prev    next >
Encoding:
Text File  |  1992-01-26  |  5.7 KB  |  199 lines
  1.  
  2.  
  3.  
  4. RLOG(1)            Printed December 19, 1991          RLOG(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      rlog - print log messages and other information about RCS
  10.      files
  11.  
  12. SYNOPSIS
  13.      rlog [ options ] file ...
  14.  
  15. DESCRIPTION
  16.      rlog prints information about RCS files.
  17.  
  18.      Pathnames matching    an RCS suffix denote RCS files;    all
  19.      others denote working files.  Names are paired as explained
  20.      in    ci(1).
  21.  
  22.      rlog prints the following information for each RCS    file: RCS
  23.      pathname, working pathname, head (i.e., the number    of the
  24.      latest revision on    the trunk), default branch, access list,
  25.      locks, symbolic names, suffix, total number of revisions,
  26.      number of revisions selected for printing,    and descriptive
  27.      text.  This is followed by    entries    for the    selected
  28.      revisions in reverse chronological    order for each branch.
  29.      For each revision,    rlog prints revision number, author,
  30.      date/time,    state, number of lines added/deleted (with
  31.      respect to    the previous revision),    locker of the revision
  32.      (if any), and log message.     All times are displayed in
  33.      Coordinated Universal Time    (UTC).    Without    options, rlog
  34.      prints complete information.  The options below restrict
  35.      this output.
  36.  
  37.      -L     Ignore    RCS files that have no locks set.  This    is
  38.      convenient in combination with    -h, -l,    and -R.
  39.  
  40.      -R     Print only the    name of    the RCS    file.  This is convenient
  41.      for translating a working pathname into an RCS    pathname.
  42.  
  43.      -h     Print only the    RCS pathname, working pathname,    head,
  44.      default branch, access    list, locks, symbolic names, and
  45.      suffix.
  46.  
  47.      -t     Print the same    as -h, plus the    descriptive text.
  48.  
  49.      -b     Print information about the revisions on the default
  50.      branch, normally the highest branch on    the trunk.
  51.  
  52.      -ddates
  53.      Print information about revisions with    a checkin
  54.      date/time in the ranges given by the semicolon-separated
  55.      list of dates.     A range of the    form d1<d2 or d2>d1
  56.      selects the revisions that were deposited between d1 and
  57.      d2 inclusive.    A range    of the form <d or d> selects all
  58.      revisions dated d or earlier.    A range    of the form d< or
  59.      >d selects all    revisions dated    d or later.  A range of
  60.  
  61.  
  62.  
  63. Page 1                     TARGON /35     Operating System
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. RLOG(1)            Printed December 19, 1991          RLOG(1)
  71.  
  72.  
  73.  
  74.      the form d selects the    single,    latest revision    dated d
  75.      or earlier.  The date/time strings d, d1, and d2 are in
  76.      the free format explained in co(1).  Quoting is normally
  77.      necessary, especially for < and >.  Note that the
  78.      separator is a    semicolon.
  79.  
  80.      -l[lockers]
  81.      Print information about locked    revisions only.     In
  82.      addition, if the comma-separated list lockers of login
  83.      names is given, ignore    all locks other    than those held
  84.      by the    lockers.  For example, rlog -L -R -lwft    RCS/*
  85.      prints    the name of RCS    files locked by    the user wft.
  86.  
  87.      -r[revisions]
  88.      prints    information about revisions given in the comma-
  89.      separated list    revisions of revisions and ranges.  A
  90.      range rev1:rev2 means revisions rev1 to rev2 on the same
  91.      branch, :rev means revisions from the beginning of the
  92.      branch    up to and including rev, and rev:  means
  93.      revisions starting with rev to    the end    of the branch
  94.      containing rev.  An argument that is a    branch means all
  95.      revisions on that branch.  A range of branches    means all
  96.      revisions on the branches in that range.  A branch
  97.      followed by a . means the latest revision in that
  98.      branch.  A bare -r with no revisions means the    latest
  99.      revision on the default branch, normally the trunk.
  100.  
  101.      -sstates
  102.      prints    information about revisions whose state
  103.      attributes match one of the states given in the comma-
  104.      separated list    states.
  105.  
  106.      -w[logins]
  107.      prints    information about revisions checked in by users
  108.      with login names appearing in the comma-separated list
  109.      logins.  If logins is omitted,    the user's login is
  110.      assumed.
  111.  
  112.      -Vn Emulate RCS version n when generating logs.  See co(1)
  113.      for more.
  114.  
  115.      -xsuffixes
  116.      Use suffixes to characterize RCS files.  See ci(1) for
  117.      details.
  118.  
  119.      rlog prints the intersection of the revisions selected with
  120.      the options -d, -l, -s, and -w, intersected with the union
  121.      of    the revisions selected by -b and -r.
  122.  
  123. EXAMPLES
  124.      rlog  -L  -R  RCS/*
  125.      rlog  -L  -h  RCS/*
  126.  
  127.  
  128.  
  129. Page 2                     TARGON /35     Operating System
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. RLOG(1)            Printed December 19, 1991          RLOG(1)
  137.  
  138.  
  139.  
  140.      rlog  -L  -l  RCS/*
  141.      rlog  RCS/*
  142.  
  143.      The first command prints the names    of all RCS files in the
  144.      subdirectory RCS that have    locks.    The second command prints
  145.      the headers of those files, and the third prints the headers
  146.      plus the log messages of the locked revisions.  The last
  147.      command prints complete information.
  148.  
  149. ENVIRONMENT
  150.      RCSINIT
  151.       options prepended to the argument list, separated by
  152.       spaces.  See ci(1) for details.
  153.  
  154. DIAGNOSTICS
  155.      The exit status is    zero if    and only if all    operations were
  156.      successful.
  157.  
  158. IDENTIFICATION
  159.      Author: Walter F. Tichy.
  160.      Revision Number: 5.3; Release Date: 1991/08/22.
  161.      Copyright O 1982, 1988, 1989 by Walter F. Tichy.
  162.      Copyright O 1990, 1991 by Paul Eggert.
  163.  
  164. SEE ALSO
  165.      ci(1), co(1), ident(1), rcs(1), rcsdiff(1), rcsintro(1),
  166.      rcsmerge(1), rcsfile(5)
  167.      Walter F. Tichy, RCS--A System for    Version    Control,
  168.      Software--Practice    & Experience 15, 7 (July 1985),    637-654.
  169.  
  170. BUGS
  171.      The separator for revision    ranges in the -r option    used to
  172.      be    - instead of :,    but this leads to confusion when symbolic
  173.      names contain -.  For backwards compatibility rlog    -r still
  174.      supports the old -    separator, but it warns    about this
  175.      obsolete use.
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195. Page 3                     TARGON /35     Operating System
  196.  
  197.  
  198.  
  199. ə